Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Manipulating Shape Object Properties

GXResetShape

You can use the GXResetShape function to reset the attributes, fill, style, ink, and transform of a shape to their default values.

void GXResetShape(gxShape target);

target

A reference to the shape object whose properties you want to reset.

DESCRIPTION

The GXResetShape function resets the shape attributes and the shape fill of the shape object specified by the target parameter to match the shape attributes and shape fill of the corresponding default shape. The function also resets the style, ink, and transform references of the target shape to their default values.

The GXResetShape function does not change the target shape's geometry, owner count, or tags.

After the GXResetShape function returns, the target shape references the same style, ink, and transform as the corresponding default shape object. The GXResetShape function increments by 1 the owner counts of the default style, ink, and transform, and disposes of the target shape's original style, ink, and transform.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
shape_access_not_allowed	(debugging version)

SEE ALSO

Default shape objects are described in the section "Default Shapes" beginning on page 2-18.

To examine a default shape, use the GXGetDefaultShape function, described on page 2-52. To replace a default shape, use the GXSetDefaultShape function, described on page 2-53.

For information on resetting typographic shapes, see the typographic shapes chapter of Inside Macintosh: QuickDraw GX Typography.